home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir36 / uud20.zip / UUD.DOC < prev    next >
Text File  |  1994-10-10  |  15KB  |  411 lines

  1. Batch UUDecoder Version 2.0 for DOS
  2. By Jeff Lee
  3.  
  4. Released: 9/16/94
  5.  
  6. Introduction
  7. ------------
  8. Welcome to the first ever (at least to my knowledge) batch 
  9. UUEncoder!  This program was primarily written for my own 
  10. purposes because I got terribly tired of uudecoding each file in 
  11. a directory manually.  You probably know the feeling.. Type 
  12. uudecode dog.. Wait for it to finish.. Type uudecode cat.. Wait 
  13. for it to finish.. etc..  Even worse were the split files!
  14. Well, with this program, if you know how to use DOS 'dir' you 
  15. know how to use UUD!  The reason for this is that UUD can 
  16. accept all standard DOS wildcards.  To solve for the split files,
  17. UUD features a fairly advanced parsing system to correctly decode
  18. the files in whatever order they may be.  In the next couple of 
  19. sections, you'll learn how to use UUD and use it to its 
  20. maximum potential.
  21.  
  22.  
  23. What is a wildcard?
  24. -------------------
  25. For those of you who have no idea what a wildcard is, it is 
  26. defined in THE COMPUTER GLOSSARY by Alan FREEDMAN as "symbols 
  27. used to represent any value when naming files".  Others of you 
  28. may know it as the symbols '*' and '?' used in the DOS DIR 
  29. command.  Basically, it makes it easier to group items toghther. 
  30.  Although the '*' and the '?' are both wildcards, they have 
  31. slightly different functions.  Here, I'll show you what I mean 
  32. with a couple of examples.  Lets say you had the following 
  33. directory:
  34.  
  35. C:\>DIR
  36.  
  37.  Volume in drive D is STACVOL_000
  38.  Directory of D:\DOWNLOAD
  39.  
  40. .            <DIR>     03-07-93   9:20p
  41. ..           <DIR>     03-07-93   9:20p
  42. ALLDOOM      <DIR>     03-02-94   7:34p
  43. EMS          <DIR>     02-12-94   8:38a
  44. FNTLIN10     <DIR>     03-28-93   2:37p
  45. GUI          <DIR>     02-17-94   7:15a
  46. ISSUE15      <DIR>     05-26-94   1:11p
  47. WMP          <DIR>     08-28-93   4:05a
  48. ARMADA   ZIP    219340 06-01-94   3:13p
  49. BRISCOJR ZIP     87031 05-29-94   8:00a
  50. DMAREACD ZIP      3362 03-02-94   3:01p
  51. DOOMV55  FAQ    142039 02-24-94   6:20p
  52. DOOMV55  ZIP     49793 02-26-94   4:22p
  53. EMSCL13  ZIP     20593 02-12-94   8:20a
  54. EZDB     ZIP     49271 02-26-94   6:52p
  55. FBTRNS   ZIP      7880 05-27-94   4:27p
  56. GAMMA    ZIP     91486 02-21-94  10:27p
  57. GIF_LIBL LIB     25600 02-20-94   5:39p
  58. GUI      ZIP    199857 02-17-94   7:14a
  59. HOWTOVC  TXT     28422 02-26-94   6:54p
  60. ISSUE15  ZIP    629578 05-26-94   1:02p
  61. NUSER    EXE     36687 02-23-94   7:31p
  62. NUSER    ZIP     19328 02-26-94   4:01p
  63. PROMODEM ZIP     65637 02-20-94   5:35p
  64. SYSSHOK  ZIP    159176 06-01-94   3:16p
  65. UNPROT   BAS         2 07-07-87  10:01a
  66. UNPROT   DOC      1476 07-07-87   9:56a
  67. UNPROT   ZIP       939 03-03-94   9:34p
  68. VOCFMAT  TXT      6212 02-12-94   2:47p
  69. UUCODE   ZIP      5289 06-09-94   7:09p
  70. DIRLIST              0 06-11-94  12:05p
  71. ASP          <DIR>     06-10-94   2:34p
  72.        32 file(s)    1848998 bytes
  73.              9142272 bytes free
  74.  
  75. You could use a command like "dir *.zip" to view all the .zip 
  76. files as so:
  77. C:\>dir *.zip
  78.  
  79.  Volume in drive D is STACVOL_000
  80.  Directory of D:\DOWNLOAD
  81.  
  82. ARMADA   ZIP    219340 06-01-94   3:13p
  83. BRISCOJR ZIP     87031 05-29-94   8:00a
  84. DMAREACD ZIP      3362 03-02-94   3:01p
  85. DOOMV55  ZIP     49793 02-26-94   4:22p
  86. EMSCL13  ZIP     20593 02-12-94   8:20a
  87. EZDB     ZIP     49271 02-26-94   6:52p
  88. FBTRNS   ZIP      7880 05-27-94   4:27p
  89. GAMMA    ZIP     91486 02-21-94  10:27p
  90. GUI      ZIP    199857 02-17-94   7:14a
  91. ISSUE15  ZIP    629578 05-26-94   1:02p
  92. NUSER    ZIP     19328 02-26-94   4:01p
  93. PROMODEM ZIP     65637 02-20-94   5:35p
  94. SYSSHOK  ZIP    159176 06-01-94   3:16p
  95. UNPROT   ZIP       939 03-03-94   9:34p
  96. UUCODE   ZIP      5289 06-09-94   7:09p
  97.        15 file(s)    1608560 bytes
  98.              9142272 bytes free
  99.  
  100. The reason for this is because the '*' symbol means basically 
  101. 'all'.  So, when you type in "DIR *.zip", you basically are 
  102. telling the computer to display any and all files with any 
  103. filename, with a .ZIP extention.  You can reverse this as well.  
  104. Doing a DIR NUSER.* would output:
  105.  
  106. C:\>dir nuser.*
  107.  
  108.  Volume in drive D is STACVOL_000
  109.  Directory of D:\DOWNLOAD
  110.  
  111. NUSER    EXE     36687 02-23-94   7:31p
  112. NUSER    ZIP     19328 02-26-94   4:01p
  113.     2 file(s)      56015 bytes
  114.              9166848 bytes free
  115.  
  116. A final use of it would be to find files starting with a letter, 
  117. or group of letters.  Take a guess at what DIR G*.* would do:
  118.  
  119. C:\>dir g*.*
  120.  
  121.  Volume in drive D is STACVOL_000
  122.  Directory of D:\DOWNLOAD
  123.  
  124. GUI          <DIR>     02-17-94   7:15a
  125. GAMMA    ZIP     91486 02-21-94  10:27p
  126. GIF_LIBL LIB     25600 02-20-94   5:39p
  127. GUI      ZIP    199857 02-17-94   7:14a
  128.     4 file(s)     316943 bytes
  129.              9166848 bytes free
  130.  
  131. Get it?  Not that hard right?  The G*.* meant all files beginning 
  132. with G with any extention.  The '?' symbol is similiar to the '*' 
  133. except that it replaces only 1 letter, instead of an entire 
  134. filename or exention.  This becomes useful when you don't want 
  135. all the files matching a '*' specification.  Lets say we only 
  136. wanted the files that had a 3 letters in their filename not 
  137. including extention.  We would do the following:
  138.  
  139. C:\>dir ???.zip
  140.  
  141. As expected, the following would occur:
  142.  
  143.  Volume in drive D is STACVOL_000
  144.  Directory of D:\DOWNLOAD
  145.  
  146. GUI      ZIP    199857 02-17-94   7:14a
  147.     1 file(s)     199857 bytes
  148.              9166848 bytes free
  149.  
  150. Well, that about covers everything with wildcards.  Just in case 
  151. you didn't know, many DOS commands accept wildcards.  As shown 
  152. here, DIR allows it.  Others include COPY, MOVE, XCOPY, ATTRIB, 
  153. and many more.  Now that you have a general idea of there usage, 
  154. lets use this knowledge to use UUD.
  155.  
  156.  
  157. Usage
  158. -----
  159. If you're here, I assume you either read the section on 
  160. WILDCARDS, or you already know how to use them.  Like I said 
  161. before, UUD has much the same format as dir in the sense that UUD 
  162. accepts wildcards.  For instance, if you had a directory full of 
  163. UUENCODED files, all you would have to do is:
  164.  
  165. UUD *.*
  166.  
  167. and voila!  All the files will automatically be decoded.  UUD 
  168. also recognizes the '?' wildcard.  So, lets say you had a 
  169. directory of files names FILE.000-FILE.500.  You could easily 
  170. decode only FILE.000-FILE.009 by using:
  171.  
  172. UUD FILE.00?
  173.  
  174. See how easy it is?  Of course, then you could decode one file at 
  175. a time.
  176.  
  177. UUD FILE.000
  178.  
  179.  
  180. HOW UUD HANDLES SPLIT FILES
  181. ---------------------------
  182. When using WILDCARDS, and UUD encounters a file that appears to 
  183. split into several parts, UUD will sort all directory entries 
  184. that satisfy the WILDCARD.  Then comes the complex part.  UUD 
  185. will search in either alphabetical or regular order (determined 
  186. by switches) for files that have the following three things in 
  187. their header:
  188.  
  189. 1)The same output file name as the first file.
  190. 2)The same number of parts as the first file.
  191. 3)The expected part number derived from the last processed file.
  192.  
  193. If UUD finds a "SECTION X", where X is a number, it will use that
  194. number instead of the part number.
  195.  
  196. By applying these two methods, UUD is fairly hard to foul up.  
  197. Most of the time, it will pick the correct entry.  Actually, you 
  198. really don't even need to know this since UUD does it 
  199. automatically.  All you have to do is sit back, and watch!
  200.  
  201.  
  202. SWITCHES
  203. --------
  204. UUD [options] filenames [output directory]
  205. Things in [] are optional.
  206.  
  207. [Options]:
  208.  
  209. -? or -h
  210. Brings up the help screen giving brief details on how 
  211. to use them.  Also displays any options that are
  212. default on.
  213.  
  214. -v
  215. Verbose Mode.  The program will display all files 
  216. that have been processed instead of showing the most 
  217. recent processed file.
  218.  
  219. -n
  220. Disables Alphabetical sorting.  All files will be 
  221. processed in the order they appear in the directory.
  222.  
  223. -o
  224. Overwrite All Existing Files.  When UUD decodes, it 
  225. usually checks to make sure the new file being 
  226. created will not overwrite an existing file.  If -o 
  227. is used, it will not ask for permission but just 
  228. write over them.
  229.  
  230. -d"directory"
  231. Where "directory" is, is a valid directory anywhere or anyplace on your
  232. computer.  This argument specifies the directory in which the files will
  233. be decoded to.  This has the same effect as using the "output directory"
  234. as the last argument.
  235.  
  236. Filenames:
  237. This can include as many files as you like, all which can take 
  238. wildcards.  You could do:
  239.  
  240. UUD dog*.* cat*.* bird*.* cow*.*
  241.  
  242. UUD will gather up all the files that match the file specifications,
  243. and then, according to switches, alphabatize or leave them alone.
  244.  
  245. [output directory]:
  246. Internally, all UUD does with this is convert it into a -d argument.  Refer
  247. to that argument for more info.
  248.  
  249.  
  250. The Configuration File
  251. ----------------------
  252. The configuration file is a simple means of saving defaults that UUD can
  253. later recall.  To create one, or edit the one provided with UUD, all you
  254. have to do is seperate each new command with a return.  Once completed
  255. and to your satisfaction, you MUST PLACE "UUD.CFG" ALONG THE PATH, or UUD
  256. WILL NOT FIND IT.  Here's an example UUD.CFG:
  257. -v
  258. -o
  259. -dd:\decodes
  260.  
  261. By creating this file, UUD will automatically activate Verbose Mode,
  262. Overwrite Mode, and decode all files to the directory "D:\DECODES".
  263.  
  264. If, at any time you want to disable some of these options, simply reuse
  265. that command on the command line when using UUD.  Example using the UUD.CFG
  266. mentioned above:
  267. UUD -v -d *.*
  268.  
  269. This command would disable verbose mode and disable the output directory while
  270. leaving Overwrite on.
  271.  
  272. You can view what options are on at any time by just doing a "UUD /?".
  273.  
  274.  
  275. REGISTRATION of UUD
  276. -------------------
  277. Think back.. Way back.. To the point in time where you were a 15 
  278. year old kid in High School.  Remember how much money meant to 
  279. you?  Now think about me.  I currently am 15 and, like you at 
  280. that time, value money A LOT.  That's why I'm placing this 
  281. program in here as SHAREWARE.  Unlike all those big guys who 
  282. charge 30-40 buckaroos for a simple program, I'm asking for only 
  283. a measly 18 that's EIGHTteen dollars.  Actually, to play it fair
  284. for all those guys who are still using Version 1.2x, I'll charge
  285. ya only 8 dollars until August 15th.  If you liked this program, 
  286. I would really REALLY appreciate it if you payed the Registration
  287. fee.  If you can't afford to pay the registration fee, let me know 
  288. you exist, and I'll send it to you EMAIL ONLY free.  I'm basing this 
  289. policy on your HONESTY.
  290.  
  291.  
  292. WHAT DO I GET WHEN I REGISTER??!!
  293. ---------------------------------
  294. Well, first of all and most importantly, you get my never ending 
  295. thanks :).  I would be so grateful that if I were able to fly out 
  296. to wherever you live, I'd give you a big smack on the cheek and 
  297. ask you if you had a NICE, TEENage DAUGHTER that doesn't 
  298. currently have a boyfriend..  Just kidding! (although that would 
  299. be nice).
  300.     Seriously, I'll send you the registered version either by 
  301. EMAIL or SNAIL MAIL whichever you choose.  You'd get FREE 
  302. upgrades to the program (as well as UUE, a UUENCODER, when I 
  303. finish it) for as long as I update this thing.  You would also 
  304. have the option to BETA test for me if you want.  Trust me, you 
  305. don't want to miss out on the upcoming versions!  Upgrades to
  306. registered users will come through EMAIL only.
  307.  
  308.  
  309. HOW DO I REGISTER??!!
  310. ---------------------
  311. If you have a printer, print the file "ORDER.DOC"
  312.  
  313. If you don't have a printer -
  314. First, you would make a check or money order out to "Jeff Lee".
  315. Then, you would send that to:
  316.  
  317. Carrot Utilities
  318. 15284 Karl Ave
  319. Los Gatos, CA 95030
  320.  
  321. Lastly, Be sure to specify either EMAIL or SNAIL MAIL.  Whatever it is,
  322. be sure to include your NAME, ADDRESS, EMAIL ACCOUNT, and DISK SIZE.
  323.  
  324.  
  325. SHAREWARE CATALOGS
  326. ------------------
  327. I'd be glad for any and all Shareware Catalogs to incorporate 
  328. this program into their catalog or software library of some sort. 
  329. I'm not asking any money from you, but I AM asking you to TELL 
  330. ME if you do include this in a catalog.  You need my written
  331. permission to encorporate UUD into your product line.  After all, 
  332. at 15 I'm looking for things to stick on my Resume, and having 
  333. a piece of software published (kinda) would be a very unique thing!
  334.  
  335.  
  336. REPORTING BUGS
  337. --------------
  338. This is a very important asset to me, especially if you find that
  339. UUD decoded a file incorrectly (I'm most worried about SPLIT 
  340. files).  I need people to tell me if they encounter any 
  341. misspellings, bugs, etc. in the program.  If possible, send me 
  342. the files you were trying to DECODE.  Send them to me at the 
  343. EMAIL addresses that appear in the next section.  Not only will I 
  344. be deeply gratified (almost as much as you paying the 
  345. registration fee), but I'll also include your name in the next 
  346. version as a sign of my thanks.
  347.  
  348.  
  349. WHERE TO REACH THE AUTHOR
  350. -------------------------
  351. Well, I'm basically everywhere:
  352.  
  353. America On-line:        TSNGonzo                        <----2nd preferred
  354. Compuserve:             70740,2337                      <----Least preferred
  355. Internet:               TSNGonzo@Netcom.com             <----Preferred
  356.  
  357.  
  358. TROUBLESHOOTING AND EVERYDAY QUESTIONS
  359. --------------------------------------
  360. When I try to run UUD from the program manager, all that happens is the screen
  361. flashes and then UUD returns me back to windows
  362.  
  363. Well, first of all, UUD is not a Windows program.  It requires the use of
  364. arguments passed on the command line.  Read this manual or type in just 'UUD'
  365. while in DOS or a DOS box.
  366.  
  367.  
  368. UUD continues to tell me that I have a "short file".
  369.  
  370. Most likely this means that you have not downloaded the complete UUEncoded
  371. file.  All UUEncoded files should end with an 'end' line.
  372.  
  373.  
  374. The Computer is talking to me now!
  375.  
  376. How'd that happen.. I know i'm a good programmer.. I'm not THAT 
  377. good.  Check to make sure your keyboard is plugged in backward so 
  378. that the oscillating chip within the computer can put the demons 
  379. away.
  380.  
  381.  
  382. Why doesn't UUD fax anything?
  383.  
  384. Try putting the sheet of paper you want to fax up to the monitor. 
  385.  Make sure the monitor has plenty of static so the paper will 
  386. stick!
  387.  
  388.  
  389. What's wrong with the author?
  390.  
  391. Right now, he's in deep mourning over the cancellation of Star 
  392. Trek: The Next Generation.  Don't worry, he'll be normal again by 
  393. the time Voyager or the movie comes out.
  394.  
  395.  
  396. DISCLAIMER
  397. ----------
  398. Ok.. I don't want anyone sueing me because this program messed 
  399. them bad or anything.  Although this program has been tested 
  400. thorougly by the author, I make no guarantee it will work 
  401. correctly on all programs.  If it messes you up, TOUGH - that's
  402. your problem.
  403.  
  404.  
  405.  
  406. All in all, I hope this program isn't TOO hard to learn.  I tried 
  407. to make it as simple as possible.
  408.  
  409. BYE!! REMEMBER TO REGISTER THIS PROGRAM!!
  410.  
  411.